home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)U / (A)U2.ADF / Dfc / README < prev    next >
Text File  |  1989-06-03  |  5KB  |  97 lines
  1. /*
  2.  *   This program will not prompt you to insert the disks if it doesn't
  3.  *   need to, so have the correct disks in the correct drives before
  4.  *   hitting the `Go' gadget!
  5.  *
  6.  *   This is dfc, a disk copying and formatting utility written by Radical
  7.  *   Eye Software.  This program is in the public domain; anyone can do
  8.  *   anything they want with it.  This software is made available on an as-is
  9.  *   basis; don't come to me if you destroy your entire fish disk library
  10.  *   with it!  Of course, it was tested rather extensively before it was
  11.  *   released . . .
  12.  *
  13.  *   This code was written with Manx 3.4b on February 8, 1988.
  14.  *
  15.  *   dfc is meant to replace both format and diskcopy, and be smaller than
  16.  *   either.  It is meant to work exactly the same as either, depending on
  17.  *   the command line arguments you give it.  In addition, it has several
  18.  *   additional options, such as buffering of a disk for a quick additional
  19.  *   copy, the ability to toggle verify mode on and off, and the ability to
  20.  *   write to multiple disks at the same time.  It also has a nice Intuition
  21.  *   interface.  It will not replace the `DiskCopy' or `Format' options from
  22.  *   the workbench, however; these have to work with the Workbench startup
  23.  *   message, which this program does not.
  24.  *
  25.  *   This program can be invoked with no command line options.  In this case,
  26.  *   it defaults to a diskcopy from df0: to df1: with verify on and buffering
  27.  *   on.  All keyword options can be preceded by a dash, for you Unix lovers
  28.  *   out there, and can be abbreviated to one character.  The following
  29.  *   parameters are accepted:
  30.  *
  31.  *   f[rom] disk       Use `disk' as the source drive.  The format for disk
  32.  *                     is completely free; only the numerals in the argument
  33.  *                     are looked at.
  34.  *   t[o] disks        Use `disks' as the destination drives.  Again, the
  35.  *                     format is unspecified.
  36.  *   v[erify]          Verify all writes (default).
  37.  *   nov[erify]        Turn off the verify mode.
  38.  *   b[uffer]          Use extra buffer memory.  If your system has enough
  39.  *                     memory, an entire disk will be cached in RAM.
  40.  *                     Otherwise, almost all of the system memory will be
  41.  *                     used.
  42.  *   nob[uffer]        Do not buffer; use minimum memory.  (Default.)
  43.  *   n[ame] diskname   Format the destination disk with name `diskname'.
  44.  *                     Otherwise a diskcopy is assumed.
  45.  *   d[...]            A drive argument.  Might not have a d; simple numbers
  46.  *                     work as well.  The first occurance of such an argument
  47.  *                     sets the source and destination fields; a subsequent
  48.  *                     occurance only sets the destination.
  49.  *
  50.  *   Thus,
  51.  *      dfc df0: name "Foo bar baz"
  52.  *   formats drive df0: and names the resultant disk "Foo bar baz".
  53.  *      dfc df0: df1:
  54.  *   diskcopies from df0: to df1:.
  55.  *      dfc -nov 0 123
  56.  *   diskcopies from drive 0 to drives 1, 2, and 3, with verify turned off.
  57.  *      dfc from df0: to df0:,df1:,df2:,df3:
  58.  *   diskcopies from drive df0: to all four drives.
  59.  *      dfc name Foo
  60.  *   formats drive df1 with the name "Foo".
  61.  *
  62.  *   Once the program opens its window up, you will have a bunch of gadgets.
  63.  *   The left-most column of gadgets is the source selection; here you can
  64.  *   choose either format, or one of the four drives.  The next column is
  65.  *   the destination column; choose any combination of the four drives by
  66.  *   clicking on the gadgets.  Lines will be drawn between these two columns
  67.  *   indicating the current selections.  If a drive is not available, no line
  68.  *   will be drawn to it.
  69.  *
  70.  *   The topmost gadget is the name gadget.  This is used to set the name of
  71.  *   your disk while formatting.
  72.  *
  73.  *   The `Go' gadget starts the program up; you had better have the disks in
  74.  *   the drives when you hit this gadget!  The `Again' gadget makes another
  75.  *   copy of the last disk, if buffering is on and enough buffers were
  76.  *   allocated for an entire disk.  This gadget requires all destination
  77.  *   disks to be in their drives already.
  78.  *
  79.  *   The `Retry' gadget tells the system to retry after a disk error.  The
  80.  *   `Quit' gadget tells the system to abort an operation; you can hit this
  81.  *   at an error, which aborts the current operation; you can hit this during
  82.  *   a copy or format operation, which does the same; or you can hit this
  83.  *   with the drives inactive, which exits the program.
  84.  *
  85.  *   The `Verify' gadget turns the verify mode on and off.  The `Buffer'
  86.  *   gadget turns buffering on and off.
  87.  *
  88.  *   All of these gadgets have keyboard shortcuts which are simply the first
  89.  *   letter of the gadget name.  The source gadgets can be selected with the
  90.  *   digits `0', `1', `2', or `3'; the destination gadgets with the shifted
  91.  *   versions of these keys (')', `!', `@', and `#'.)  The carriage return
  92.  *   key is a synonym for `Go', for added diskcopy and format compatibility.
  93.  *
  94.  *   Enjoy this program!  Please send any bug reports to Tomas Rokicki,
  95.  *   Box 2081, Stanford, CA  94309.
  96.  */
  97.